Dokumentation für VBXE

← Zurück zum Forum

Dokumentation für VBXE

Auf dem Summercamp kam eine Diskussion über den Zustand der VBXE-Dokumentation auf. Wir waren uns einig, dass die Dokumentationen, insbesondere für Anfänger, lückenhaft und unverständlich sind.

Darauf hin hat meine Frau dann mal Claude zu VBXE befragt. Das Ergebnis war schon interessant und daher habe ich die Generierung von Dokumentation vertieft und Claude auch Beispiele in Assembler und C (mit llvm-mos) erstellen lassen.

Das Ergebnis findet sich hier: Github.

Ich habe noch nicht die Muse gehabt, die Beispiele selbst auszuprobieren.

Ich würde daher die Experten hier bitten, die Dokumentation und die Beispiele zu prüfen. Sollten es Änderungswünsche geben, bitte ich um Pull Requests oder Nachricht an mich.

AntwortZitat

Ich würde meine Hände nicht für jedes Details ins Feuer legen, aber soweit ich VBXE-Programmierung verstehe, sehen die Sachen plausibel aus.

AntwortZitat

Jochen.Schäfer schrieb am 13.10.2026 09:36: Ich würde daher die Experten hier bitten, die Dokumentation und die Beispiele zu prüfen. Sollten es Änderungswünsche geben, bitte ich um Pull Requests oder Nachricht an mich.

ich finde dieses Vorgehen bedenklich: das Befragen eines LLM ist der einfache Teil der Aufgabe, das Prüfen der Informationen ist die (nicht immer spannende und interessante) Arbeit.

So besteht nun die Gefahr, dass niemand die Daten prüft. Die (möglicherweise falschen) Daten sind nun öffentlich auf Github, werden dort von Menschen und von KI-Scrapern gelesen, die Daten werden wieder zum Anlernen neuere KI-Systeme verwendet. Hierdurch nimmt die Qualität der Information immer mehr ab.

Ich schlage vor das Github-Repo mindestens auf "privat" zu stellen, noch besser bis zur vollständigen Prüfung der Daten zu löschen (denn Microsoft lernt möglicherweise auch CoPilot mit privaten Repos an).

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Dann lösche ich eben alles.

Es scheint ja keinen Bedarf zu geben an einer Dokumentation, die jheder verstehen kann, dann lassen wir das halt.

AntwortZitat

Jochen.Schäfer schrieb am 14.10.2026 09:47:

Dann lösche ich eben alles.

Es scheint ja keinen Bedarf zu geben an einer Dokumentation, die jheder verstehen kann, dann lassen wir das halt.

Ich glaube, das ist vorschnell. Ich würde annehmen, daß von den 500+ Clubmitgliedern vielleicht 10 ein VBXE haben. Ich hab zum Beispiel keins. Wenn von diesen 10 Leuten hier 3 mitlesen und davon dann einer Ahnung von der Programmierung hat dann liegt hier wie ich glaube die Ursache für wenig Echo.

Ich habe immer Interesse an einer verständlichen und korrekten Doku. Aber ich hab halt kein VBXE.

Jede Info, die zu Hause auf meinem Rechner liegt habe ich unterwegs nicht verfügbar. Jede Info, die im Netz liegt finde ich nicht wieder, wenn ich sie benötige.

AntwortZitat

Jochen.Schäfer schrieb am 14.10.2026 09:47:

Dann lösche ich eben alles.

Es scheint ja keinen Bedarf zu geben an einer Dokumentation, die jheder verstehen kann, dann lassen wir das halt.

Sorry, das habe ich auf keinen Fall gemeint, bitte nicht eingeschnappt sein.

Es gibt Bedarf für gute Dokumentation, aber ungeprüfte LLM Dokumentation macht die Situation nicht besser, eher schlechter.

Was wir brauchen ist gute, getestete Dokumentation.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Catch-22 würde ich sagen: Es soll geprüft werden, aber es soll nicht ungeprüft im Internet stehen. Das funktioniert nicht.

Außerdem habe ich ja bereits angedeutet, dass ich das schon gelesen habe und es korrekt aussieht. Das Dokumentierte ist auf keinen Fall eine Halluzination. Es werden auch Dokumente referenziert, die zur Geniererung benutzt wurden.

Bei solchen Einwänden fällt es mir dann doch sehr schwer noch die Motivation zu finden, irgendwas zu machen.

AntwortZitat

Alo zwei meiner XLs haben VBXE. Wäre aber tatsächlich mal interessant, zu wissen, wie viele Clubmitglieder ein VBXE haben.

AntwortZitat

Jochen.Schäfer schrieb am 14.10.2026 10:29:

Catch-22 würde ich sagen: Es soll geprüft werden, aber es soll nicht ungeprüft im Internet stehen. Das funktioniert nicht.

Doch. Du kannst das Repo erst einmal auf "privat" stellen, dann hier ankündigen mit der Info, dass noch nicht alles getestet ist und mit der Bitte ob es Mitstreiter gibt welche testen können.

Zum grundlegendem Testen reicht ja auch ein Altirra-Emulator.

Das Testen kann auch mit LLM (KI) Unterstützung geschehen, z.B. das Einrichten einer LLVM-MOS6502 Umgebung, Kompilieren und Testen der Beispiele.

Nach dem erfolgreichen Test kann das Repo dann auf "öffentlich" gestellt werden.

Ob die Bildschirmausgabe des VBXE dann mit den Beschreibungen übereinstimmt sollte noch ein Mensch prüfen.

Außerdem habe ich ja bereits angedeutet, dass ich das schon gelesen habe und es korrekt aussieht. Das Dokumentierte ist auf keinen Fall eine Halluzination. Es werden auch Dokumente referenziert, die zur Geniererung benutzt wurden.

Bei solchen Einwänden fällt es mir dann doch sehr schwer noch die Motivation zu finden, irgendwas zu machen.

Sorry, ich war zu undiplomatisch bei der Beschreibung meiner Kritik. Die Kritik war konstruktiv gemeint.

Bei dem Thema bin ich gerade etwas dünnhäutig: Ich laufe bei der Arbeit, aber auch beim ABBUC, immer wieder in Situationen in welchen mir die Ausgabe eines LLM als "Lösung" präsentiert wird, aber nicht genug geprüft wurde. Das macht unnötige Mehrarbeit.

Das Erstellen von Dokumentationen durch LLM ist "billig", (fast) jeder Entwickler hat heute Zugriff auf eine LLM und kann sich eine LLM-VBXE-Dokumentation erstellen. Der Mehrwert einer solchen Dokumentation kommt, aus meiner Sicht erst, wenn diese auch getestet und validiert wurde, denn das macht Arbeit und ist nicht trivial.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

patjomki schrieb am 14.10.2026 10:32:

Alo zwei meiner XLs haben VBXE. Wäre aber tatsächlich mal interessant, zu wissen, wie viele Clubmitglieder ein VBXE haben.

Ich hab kein VBXE, und auch keine Rapidus/Antonia/... Erweiterungen, und hab auch nicht vor mir irgendwas davon anzuschaffen.

so long,

Hias

AntwortZitat

Ich habe das Github-Repo geforked und werde versuchen heute Nachmittag zu testen und die Beispiele zu validieren.

Ich habe einen Atari 130XE mit VBXE, nur suche ich seit über 5 Jahren nach einem Monitor welcher die Ausgabe-Daten des VBXE darstellen kann (Beetle hat eine Monitor an welchem dieser Rechner eine Ausgabe zeigt, es geht also, aber alle meine Monitore können das Bild nicht synchronisieren).

Ich werde den Rechner noch einmal raussuchen und schauen ob ich das VBXE mit einem Monitor zum Laufen bekomme.

Wenn das klappt teste ich auch auf echter Hardware.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

cas schrieb am 14.10.2026 11:08:

Jochen.Schäfer schrieb am 14.10.2026 10:29:

Catch-22 würde ich sagen: Es soll geprüft werden, aber es soll nicht ungeprüft im Internet stehen. Das funktioniert nicht.

Doch. Du kannst das Repo erst einmal auf "privat" stellen, dann hier ankündigen mit der Info, dass noch nicht alles getestet ist und mit der Bitte ob es Mitstreiter gibt welche testen können.

Bei der extrem hohen Affinität 😈 unserer Mitstreiter für neue Technologien, gehe ich von einem einstelligen Prozentsatz aus, der ein Github-Konto hat; und meines Wissens ist das für ein privates Repo zwingend notwendig.

AntwortZitat

DjayBee schrieb am 14.10.2026 11:26:

cas schrieb am 14.10.2026 11:08:

Jochen.Schäfer schrieb am 14.10.2026 10:29:

Catch-22 würde ich sagen: Es soll geprüft werden, aber es soll nicht ungeprüft im Internet stehen. Das funktioniert nicht.

Doch. Du kannst das Repo erst einmal auf "privat" stellen, dann hier ankündigen mit der Info, dass noch nicht alles getestet ist und mit der Bitte ob es Mitstreiter gibt welche testen können.

Bei der extrem hohen Affinität 😈 unserer Mitstreiter für neue Technologien, gehe ich von einem einstelligen Prozentsatz aus, der ein Github-Konto hat; und meines Wissens ist das für ein privates Repo zwingend notwendig.

Ja, aber zum Testen ist auch zwingend notwendig das man MADS und LLVM-MOS installieren kann, und wer das kann, hat wahrscheinlich auch einen Github Account.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Ich bin kein MADS Experte, aber es scheint mir, als ob die Assembler-Beispiele so im MADS nicht übersetzt werden können.

Die Beispiele benutzen lokale Label in der Form ".label". Mit "." fangen im MADS nach meinem Verständnis nur Assembler-Direktiven an, lokale Label starten mit "?label".

Kann das sein das die LLM hier die Assembler-Syntax verschiedener Atari-Assembler vertauscht hat?

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

In der Datei 03_overlay_sr_modus.asm versucht die LLM in Zeile 260 einen Sprung mittels bne (Branch-not-equal) von über 127 Bytes, was nicht geht.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

In Datei 04_blitter_demo.asm gibt es in Zeile 85 einen BCC > 127 Bytes, assembliert nicht

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Ich habe nun die Assembler-Fehler gefixed.

Anbei die übersetzten Beispiele.

Wer ein VBXE hat, bitte einmal testen (und gegen die Dokumentation prüfen, ob die Programme das machen was in der Dokumentation steht).

Anhänge:

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Die von der LLM erzeugten Quelltexte hatten genau die Probleme welche ich befürchtet hatte: es sieht sehr "richtig" aus (Ausgaben von LLM sehen in den meisten Fällen "richtig" aus, das ist Teil der Gefahr von LLMs), sie waren es aber nicht.

Bei einer Dokumentation 'for Dummies' führt soetwas zu Frust bei den Benutzern der Dokumentation und der Beispiele.

Ich habe die formalen Fehler nun gefixed (PR kommt), ich erwarte aber noch inhaltliche Fehler im Code (und vielleicht auch in der Dokumentation).

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

cas schrieb am 14.10.2026 11:08:

Jochen.Schäfer schrieb am 14.10.2026 10:29:

Catch-22 würde ich sagen: Es soll geprüft werden, aber es soll nicht ungeprüft im Internet stehen. Das funktioniert nicht.

Doch. Du kannst das Repo erst einmal auf "privat" stellen, dann hier ankündigen mit der Info, dass noch nicht alles getestet ist und mit der Bitte ob es Mitstreiter gibt welche testen können.

Wie bekommen die Mitstreiter alles? Per ZIP in diesem Forum, dass auch öffentlich ist? Das verlagert nur alles. Mal ganz davon ab, dass Privat bei Github sehr wahrscheinlich nicht viel bedeutet.

AntwortZitat

Ich habe einen Atari 130XE mit VBXE

Wenn wir jetzt noch einen User mit VBXE finden, der hier mitliest, haben wir die Quote von @Jochen.Schäfer schon erreicht 🙂👍

AntwortZitat

Jochen.Schäfer schrieb am 14.10.2026 13:08:

Wie bekommen die Mitstreiter alles? Per ZIP in diesem Forum, dass auch öffentlich ist? Das verlagert nur alles. Mal ganz davon ab, dass Privat bei Github sehr wahrscheinlich nicht viel bedeutet.

nicht als ZIP hier, sondern privaten Zugriff auf das Repo.

Ein "privates" Repo ist nicht 100% sicher, aber viel besser als ein offenes Repo.

Alternative wäre ein eigenes Git-Repo auf einem eigenen Server, oder ein Ordner auf einem Cloud-Server (gerne auch auf der ABBUC-Nextlcoud) bei dem nur die Mitstreiter Zugriff haben.

E-Mail direkt zwischen den Mitstreitern wäre auch gut.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

cas schrieb am 14.10.2026 13:25:

Jochen.Schäfer schrieb am 14.10.2026 13:08:

Wie bekommen die Mitstreiter alles? Per ZIP in diesem Forum, dass auch öffentlich ist? Das verlagert nur alles. Mal ganz davon ab, dass Privat bei Github sehr wahrscheinlich nicht viel bedeutet.

nicht als ZIP hier, sondern privaten Zugriff auf das Repo.

Ein "privates" Repo ist nicht 100% sicher, aber viel besser als ein offenes Repo.

Alternative wäre ein eigenes Git-Repo auf einem eigenen Server, oder ein Ordner auf einem Cloud-Server (gerne auch auf der ABBUC-Nextlcoud) bei dem nur die Mitstreiter Zugriff haben.

E-Mail direkt zwischen den Mitstreitern wäre auch gut.

Ich verstehe hier überhaupt nicht die Panik, sorry.

AntwortZitat

cas schrieb am 14.10.2026 11:08:

Das Erstellen von Dokumentationen durch LLM ist "billig", (fast) jeder Entwickler hat heute Zugriff auf eine LLM und kann sich eine LLM-VBXE-Dokumentation erstellen. Der Mehrwert einer solchen Dokumentation kommt, aus meiner Sicht erst, wenn diese auch getestet und validiert wurde, denn das macht Arbeit und ist nicht trivial.

Ja, genau. Und der Zweck der Übung war nur einen Startpunkt zu liefern und nicht die endgültige Wahrheit zu präsentieren. Mir ist SEHR bewusst, dass hier noch einiges fehlt, aber keiner fängt mal an mit einer kompletten Dokumentation, die auch Anfänger verstehen kann.

AntwortZitat

Jochen.Schäfer schrieb am 14.10.2026 14:36:

cas schrieb am 14.10.2026 11:08:

Das Erstellen von Dokumentationen durch LLM ist "billig", (fast) jeder Entwickler hat heute Zugriff auf eine LLM und kann sich eine LLM-VBXE-Dokumentation erstellen. Der Mehrwert einer solchen Dokumentation kommt, aus meiner Sicht erst, wenn diese auch getestet und validiert wurde, denn das macht Arbeit und ist nicht trivial.

Ja, genau. Und der Zweck der Übung war nur einen Startpunkt zu liefern und nicht die endgültige Wahrheit zu präsentieren. Mir ist SEHR bewusst, dass hier noch einiges fehlt, aber keiner fängt mal an mit einer kompletten Dokumentation, die auch Anfänger verstehen kann.

Aber das (was Du oben schreibst) steht nirgendwo in dem Repo. Das Repo macht den Eindruck, dass alles schon fertig ist, und dass die Anleitungen und Beispiele korrekt sind.

Ich habe gerade alle ASM-Beispiele im Altirra-SDL getestet. Ich habe vorher sichergestellt, dass VBXE-Emulation im Altirra funktioniert, indem ich erfolgreich einige VBXE-Demos und -Spiele getestet habe.

Leider funktioniert keines der ASM-Beispiele aus dem Repo (die C-Beispiele habe ich noch nicht getestet). Alle Beispiele führen bei mir im Test zu einem Crash des (emulierten) Rechners.

Meine Kritik ist: Eine Dokumentation, die den Anschein hat, dass sie korrekt und getestet ist, die aber unvollständig und fehlerhaft ist, ist schlechter als keine Dokumentation.

Besser: mit dem ersten Beispiel anfangen (01_detect_vbxe.asm), testen und sicherstellen, dass dieses Beispiel funktioniert. Dann dieses Beispiel dokumentieren. Danach das zweite Beispiel usw.

Hier sehe ich die Gefahr, dass niemand sich diese Information korrigiert, dass die falschen Informationen dort draußen bleiben und nicht zu mehr VBXE-Programmen, sondern zu weniger VBXE-Programmen führen.

Newbies, welche das Repo finden, werden nur frustriert sein, da nichts funktioniert.

Sorry, Du bekommst meinen Frust ab, da ich dieses Problem mannigfaltig im Netz, auf der Arbeit und auch im ABBUC sehe.

Ich finde die Idee sehr gut, eine VBXE-Dokumentation für Einsteiger zu schreiben. Auch gerne mit LLM-Hilfe. Aber bitte die Informationen vor der Publikation prüfen und testen (auch das geht mit LLM wenn man das nicht 100% selbst machen möchte).

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Hallo!

Ich möchte ungern Salz in die Wunde streuen, aber ich finde mal eben Claude oder ChatGPT eine Doku über ein Thema erstellen zu lassen, wovon diese Systeme ebenfalls nur wenig Ahnung haben, ist der falsche Ansatz. Außerdem habe ich mir die Dokumentation angesehen... ich bin jetzt nicht unbedingt ein Anfänger... sehe da aber überhaupt kein Einstiegspunkt wie ich daraus den Umgang mit der VBXE lernen kann.

Was ich wirklich bräuchte wäre eine Anleitung, wie man mit der VBXE umgeht.. von "Hallo Welt", über das einladen von Bildern bis zu den ersten mehrfarbigen Sprites.

LLM als Werkzeug zu nutzen ist dabei legitim und würde ich niemals verurteilen. Aber wie bei jedem Programm, sollte der Programmierer die Kontrolle über dieses haben und nicht die KI. (Ersetze "Programm" mit "Dokumentation")

KI ist leider aktuell zudem ein Reizthema... :-)

Grüße Janko

Mein 600XL ist virenfrei!

AntwortZitat

HiassofT schrieb am 14.10.2026 11:13:

patjomki schrieb am 14.10.2026 10:32:

Alo zwei meiner XLs haben VBXE. Wäre aber tatsächlich mal interessant, zu wissen, wie viele Clubmitglieder ein VBXE haben.

Ich hab kein VBXE, und auch keine Rapidus/Antonia/... Erweiterungen, und hab auch nicht vor mir irgendwas davon anzuschaffen.

so long,

Hias

👍 (CharlieChaplin)

Same here.

AntwortZitat

Ich, als (mehrfacher VBXE-Besitzer 😉) habe das Thema hier ja mal mitverfolgt.

Die Motivation von Jochen finde ich ja prinzipiell gut und lobenswert, aber am Ende muss ich Carsten recht geben.

Die Leute verlassen sich leider immer mehr darauf, "dass das alles bestimmt schon so okay ist und funktioniert", was uns Claude & Co da so auswirft, und prüfen immer weniger gegen, ob es dann auch wirklich so ist. Damit tut man sich und den anderen keinen echten Gefallen...

Nur mal als Gegenbeispiel:
Ich habe ja bei der Sillyventure immer ein paar VBXE-Slideshows gezeigt und mich selber vor kurzem z.B. mal drangemacht, einen richtig guten, verbesserten "DAP-Player+" zu bauen.

Und natürlich habe ich dafür auch die KI als Werkzeug mit zur Hilfe genommen, aber dafür habe ich jeden einzelnen noch so winzig kleinen Programmmierschritt immer erst in Altirra und wichtig auch, auf echter Hardware(!) getestet, bevor ich da ein Häcken dran und weiter gemacht und mich von Versionsschritt zu Versionsschritt weiter da durchgebissen habe.

Das hat auch mehrere Tage in Anspruch genommen (und mich auch Nerven gekostet😏), aber das Ergebnis dafür, ist, dass das Programm jetzt einwandfrei funktioniert und alles (auch die Fails) dokumentiert sind.

Der Player hat jetzt folgende neue bzw erweiterte Features:

  1. Umfangreiches Startmenü bekommen
  2. Limitierung auf max. 16 Bilder aufgehoben (z.Zt. bis zu 62 Bilder möglich da MyDos bis zu 64 Einträge pro Directory max. verwaltet)(es gingen theoretisch mehr, aber dann muß man mehrere Partionen verwenden)
  3. Bilder müssen nicht mehr zwingend D01.dap bis D16.dap heissen
  4. Bilder können jetzt beliebige Namen (8+3 Format) haben und eine Routine liest am Anfang das aktuelle Directory aus und zeigt an wieviel Bilder gefunden wurden
  5. Die Wiedergabe Routine ist wählbar "Normal" / oder "Random Play"
  6. Neue verschiedene Überblend-Effekte eingebaut: Hier kann man wählen: "OFF" (normales Aus- und wieder Einblenden während die Show läuft, die Geschwindigkeit dafür wurde beschleunigt), dann "SEQ" (er spielt alle Effekte hintereinander ab) oder "RANDOM" (er spielt die Effekte Random ab).
  7. Er erkennt auf welche Adresse die VBXE liegt
  8. Man kann während der Show mit "M" immer wieder ins Menü zurückkehren
  9. Man kann mit "P" ein Bild pausieren und dauerhaft anzeigen
  10. die Laderoutine wurde etwas beschleunigt und optimiert

Hier mal ein Screenshot vom Menü:

post_andymanone_2026.10.14_16:44_1_paste_1.jpg

Ich werden den Player jetzt auf der SV2026WE im November 2026 präsentieren und danach dann auch veröffentlichen und frei zur Verfügung stellen .

Also lange Rede, garkein Sinn, was ich damit sagen wollte😉:

VBXE Entwicklungen & Tutorials / Dokumentationen (auch mit Hilfe von LLM`s!) sind lobenswert und absolut zu begrüssen, aber wie Carsten schon sagt, bevor man sie "öffentlich im Netz zur Verfügung stellt" sollte man unbedingt vorher verifizieren, ob die Sachen auch wirklich funktionieren.

Gtx.,
andY

Anhänge:

Ressortleiter Hardware - Save the past and use the future!© | andYManOne | Demozoo | Live 24/7 Stream - Industrial - Chiptune/Covers - Vocal Dream - EDM - Indie - own tracks

AntwortZitat

Sorry, wenn ich jetzt Veteranen vor den Kopf stosse, aber:

  • Ich höre nur "Doku gut, mit AI böse", aber keiner hier hat mal damit angefangen.
  • Ich habe nie behauptet, das ist der Weisheit letzter Schluß, sondern es ging erstmal nur darum eine Basis zu schaffen. Die Kritik, die ich hier hörte, hat nicht zur Verbesserung geführt (außer Carsten).
  • Carsten hat trotz seiner Kritik einfach die Labels korrrigert. Das war wohl das einzige, was beim aktuellen MADS wohl ein Problem war. Das ist was ich mir vorstellte. Eine Zusammenarbeit, die eine bessere verständliche Dokumentation, die nicht nur eine Referenz ist, zu erstellen.
  • Ich habe leider bei dieser ganzen Diskussion den Eindruck (ich kann falsch liegen), dass hier das typische deutsche Syndrom von "Alles falsch, aber ich will daran nichts ändern" zu schlägt.
  • Selbst wenn ich das Repo jetzt auf Privat setze (eine höhere Hürde, denn dann muss das Sichtbarkeit für jeden einzeln freigeben), ändert sich daran gar nichts. Dann lösche ich lieder das Ganze und verwende meine Zeit auf RespeQt.

Sorry das musste jetzt mal raus.

AntwortZitat

Ohne Veröffentlichung gibt es keine Diskussion und ein privates Repo ist keine Veröffentlichung.

Dass KI-Crawler jeden Scheiß aufsaugen, ist so und lässt sich von uns nicht lösen; und wenn Jochens KI zu den aktuellen nur teilweise richtigen Schlüssen kommt, tut das jede andere KI auch - egal ob aus den originalen Quellen oder aus Jochens Repo.

Für die Neulinge, die die Doku für eigene Projekte nutzen wollen - das aber wegen der aktuellen Unsauberkeiten nicht oder nur bedingt können - bietet sich ein fetter Disclaimer im Readme des Repos an, dass es sich (noch) um eine ungefilterte KI-Antwort handelt UND Jochen um Mithilfe bei der Finalisierung bittet.

AntwortZitat

Jochen.Schäfer schrieb am 15.10.2026 07:22:

Sorry, wenn ich jetzt Veteranen vor den Kopf stosse, aber:

  • Ich höre nur "Doku gut, mit AI böse", aber keiner hier hat mal damit angefangen.
  • Doku von Menschen geschrieben, ungetestet -> nicht gut
  • Doku von KI geschrieben, ungetestet -> nicht gut
  • Doku von Menschen geschrieben und getestet -> gut
  • Doku von KI geschrieben und (von KI oder Mensch) getestet -> gut
  • Carsten hat trotz seiner Kritik einfach die Labels korrrigert. Das war wohl das einzige, was beim aktuellen MADS wohl ein Problem war.

Es gab noch mehr formale Probleme (zu grosse Sprünge mit Branch), und eine ganze Reihe inhaltliche Probleme die noch offen sind

  • Selbst wenn ich das Repo jetzt auf Privat setze (eine höhere Hürde, denn dann muss das Sichtbarkeit für jeden einzeln freigeben), ändert sich daran gar nichts.

Doch, die Situation wird nicht noch schlimmer dadurch das die (fehlerhafte) Dokumentation wieder zum Anlernen von neuen KI Modellen verwendet wird

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Ich habe jetzt einfach keine Lust mehr. Ich lösche das Repo und dann warten wir eben nochmal 50 Jahre auf eine vernünftige Doku.

Und diesen Thread könnt ihr auch gleich löschen.

AntwortZitat

Mein Vorschlag: das Repo löschen (ich lösche auch meinen Fork) und das Projekt nochmal neu und strukturiert starten.

Die Idee der Beispiele und der Dokumentation war gut, nur die Ausführung (durch die LLM) war lausig schlecht.

Wir sollten bei den Beispielen die Ideen der Beispiele einsteigen, und diese einzeln aufbereiten, testen (Altirra, Hardware Core alt, Hardware Core neu), Dokumentieren und dann veröffentlichen.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

cas schrieb am 14.10.2026 13:25: E-Mail direkt zwischen den Mitstreitern wäre auch gut.

Jetzt ist ja eh zu spät, da Jochen ja (sehr schnell, wie ich finde) hingeschmissen hat, aber nutzen wir Basecamp für Buchprojekte jetzt nicht mehr?

AntwortZitat

andymanone schrieb am 14.10.2026 16:44:

Ich, als (mehrfacher VBXE-Besitzer 😉) habe das Thema hier ja mal mitverfolgt

🙂👍

Damit hätten wir Jochens Quote schonmal erfüllt. 🙂🙂🙂

AntwortZitat

andymanone schrieb am 14.10.2026 16:44:

[snip] Der Player hat jetzt folgende neue bzw erweiterte Features:

  1. Umfangreiches Startmenü bekommen
  2. Limitierung auf max. 16 Bilder aufgehoben (z.Zt. bis zu 62 Bilder möglich da MyDos bis zu 64 Einträge pro Directory max. verwaltet)(es gingen theoretisch mehr, aber dann muß man mehrere Partionen verwenden)

Idee: Mache das Programm kompatibel zu Bewe-DOS bzw. dem SDFS. Bewe braucht kein RAM unter dem OS, unterstützt pro Directory bis zu 1424 Dateien. Man kann das Programm dann problemlos von Harddisk oder großen ATR Images laden und kann (!) entweder alles in einer Directory oder in mehreren Subdirs drin haben.

Sage ich jetzt mal eben so, obwohl ich kein VBXE besitze und SDFS selber gar nicht nutze. (SDFS = Sparta DOS File System, genutzt von SpartaDOS, SDX, Real DOS und Bewe DOS.) Habe aber als nicht-Programmierer keine Ahnung, wieviel Aufwand das ist...

AntwortZitat

patjomki schrieb am 15.10.2026 13:57:

cas schrieb am 14.10.2026 13:25: E-Mail direkt zwischen den Mitstreitern wäre auch gut.

Jetzt ist ja eh zu spät, da Jochen ja (sehr schnell, wie ich finde) hingeschmissen hat, aber nutzen wir Basecamp für Buchprojekte jetzt nicht mehr?

Basecamp benutzen wir für ABBUC interne Projekte. Ich sehe eine VBXE-Dokumentation aber nicht als ein ABBUC Projekt.

Basecamp kostet uns pro Benutzer Geld, daher möchten wir dort die Benutzer überschaubar halten. Aus anderen Gründen möchte ich auch, dass der der ABBUC Basecamp mittelfristig verlässt. Die Funktionen von Basecamp (welche wir beim ABBUC benutzen) werden hier in das Forum einfliessen.

Ein Dokumentationsprojekt sollte generell offen sein für alle, und auch die Informationen sollten öffentlich sein (nachdem sie getestet wurden und funktionieren).

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

cas schrieb am 15.10.2026 14:47:

Aus anderen Gründen möchte ich auch, dass der der ABBUC Basecamp mittelfristig verlässt.

DHH?

AntwortZitat

cas schrieb am 15.10.2026 14:47: Aus anderen Gründen möchte ich auch, dass der der ABBUC Basecamp mittelfristig verlässt. Die Funktionen von Basecamp (welche wir beim ABBUC benutzen) werden hier in das Forum einfliessen.

Die anderen Gründe wären ja mal interessant. 🙂 Also ich finde Basecamp zwar durchaus brauchbar aber auch ein bisschen umständlich. Wäre von daher toll, wenn es übers Forum ginge. Dann hätte man auch nur eine Anlaufstelle.

AntwortZitat

habe mir den ASM-Beispiel-Code genauer angeschaut.

Das Basis-Problem bei den Assembler-Beispielen: in "vbxe_lib.asm" wird das Assemble-Origin (ORG) with auf $80 gesetzt um Zero-Page Variablen zu füllen.

Danach wird aber das Origin nicht auf einen sinnvollen Programm-Bereich gesetzt, so das der Code erst in der zweiten Hälfte der Zero-Page landet, und danach in den Stack-Bereich ab $100 assembliert wird. Das überschreibt den Stack und der Atari springt wild im Speicher -> Absturz.

🤦

Ich habe jetzt ein VBXE-Entwicklungssystem mit AltirraSDL laufen, ich versuche mal die Beispiele neu zu schreiben und zu dokumentieren.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Schade, dass hier so schnell wieder hingeschmissen wurde. Vielleicht kann man das ja zusammen doch irgendwie retten.

Einen org nach $80 im MADS. Das geht auch schöner und vor allem auch besser anpassbar, da man festlegen kann ab wo das sein soll.

Man bestimmt seine Variablen einfach über:

   .zpvar  .byte eins,zwei,drei
   .zpvar  .word vier

etc.

Übrigens @andymanone wir müssen noch unbedingt sehen, ob Du mir nicht eine oder beide meine VBXE einbauen könntest in meine Rechner 😉

PP´s of STARSOFTBerlin____github|meine Webseite|Demozoo

AntwortZitat

pps schrieb am 15.10.2026 18:56:

Schade, dass hier so schnell wieder hingeschmissen wurde. Vielleicht kann man das ja zusammen doch irgendwie retten.

ja, das habe ich vor. Die Idee ist sehr gut.

Ich schreibe die Beispiele neu, ich habe die jetzt schon soweit debugged (da waren etliche Fehler drin) das alle Beispiele funktionieren (im Altirra, aber noch nicht auf echter HW getestet).

Ich werde den Quellcode für FastAssembler schreiben, dann kann der Code auf dem Atari aber auch auf dem PC (mit MADS) assembliert werden.

Eine Artikelreihe dazu im Magazin? Vielleicht zu sehr Nische. Aber eine Dokumentation im Web mit Repo und handgetesteten Beispielen werde ich erstellen.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

cas schrieb am 15.10.2026 20:48:

Ich werde den Quellcode für FastAssembler schreiben, dann kann der Code auf dem Atari aber auch auf dem PC (mit MADS) assembliert werden.

Eine Artikelreihe dazu im Magazin? Vielleicht zu sehr Nische.


Ich würde nicht zwingend meinen, daß eine Artikelreihe im Mag zu sehr Nische ist.

Selbst wenn nur wenige Leute ein VBXE haben bleibt immer noch der "Lernstoff" FastAssembler übrig.

Jede Info, die zu Hause auf meinem Rechner liegt habe ich unterwegs nicht verfügbar. Jede Info, die im Netz liegt finde ich nicht wieder, wenn ich sie benötige.

AntwortZitat

Ich habe heute mehrere Monitore und Kabel an meinem 130XE mit VBXE getestet, und ich bekomme nur auf einem Fernseher ein sehr blasses graues Bild. Nichts zum Testen.

Ich muss noch weiter suchen. Ohne echte Hardware ist das Testen schwierig ...

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Gerade erst lese ich diesen Post... schade, daß ich nun keine Möglichkeit habe, die Sachen zu testen. Ich finde es super, wenn wir uns hier mit VBXE beschäftigen und warum sollte man denn die KI nicht nutzen?

Ich hatte mich ja unlängst sehr intensiv mit VBXE beschäftigt und halte es für eine der sinnvollsten Erweiterungen der letzten Jahre. Auch Jankos Board hat VBXE sinnvollerweise drin!!

Die Dokumentation und die Programmierung von VBXE ist wirklich nicht sehr eingängig. Man bräuchte ein eigenes kleines Buch, wo man am besten in Mads/Assembler von "Hallo Welt" auf komplexe Programme rangeführt wird.

Ich könnte mir hierzu ein Team gut vostellen, die das zusammen entwickelt.... vielleicht besprecht ihr das mal auf der JHV (wo ich leider leider nicht dabei bin). In so einem Team wäre ich gerne sofort mit dabei...

AntwortZitat

@Jochen.Schäfer könntest du mir die gelöschte Beiträge nochmal senden? Ich würde die sehr gerne testen und sichten...

AntwortZitat

Zur Info, es gibt nun eine neue Firmware für das VBXE. Dort gibt es dann scheinbar auch einige Verbesserungen - aber auch eine Einschränkung: Beim FX core gibt es nun keine zusätzliche RAM Disk mehr. Electron meinte, dass dieses Feature ein Problem sei und daher entfernt wurde. Er empfiehlt den Rechner besser mit anderer RAM Erweiterung auszustatten (intern oder extern).

Hier könnt ihr die Firmware 1.27 finden: AtariAge

PP´s of STARSOFTBerlin____github|meine Webseite|Demozoo

AntwortZitat

EXAKT das Problem hatte ich auch mit VBXE im 130XE!

Ich wollte ein SCART-Kabel über eine 13-polige ST-Buchse nutzen. Erstens: Die ST-Buchse ist widerlich zu löten. Zweitens: SCART ist widerlich zu löten.

Beetle hat versucht mir zu helfen, aber vier SCART-Kabel - die alle an meinen ST(e)s einwandfrei funktionieren - haben nur das von Dir beschriebene Ergebnis gebracht.

Ich dachte erst, es hätte vielleicht was mit der Antonia 2 zu tun, die ich noch mit reingepackt habe, aber das war es nicht.

Beetle meinte, meine TVs (drei verschiedene getestet, wo wie gesagt mit ST(e) alles läuft) würden eventuell nicht auf RGB umschalten, aber das war mit dann alles zu stressig.

Für mich ist SCART einfach gestorben, den Müll tue ich mir nicht mehr an.

Meine Lösung: Back to the roots, 9-polige Buchse rausgeführt, mit Joystick-Verlänergungskabel ran an die Röhre über die 9-polige Buchse: löppt einwandfrei. :)

Also: Wenn Du SCART nutzen willst, hast Du zwei Möglichkeiten: 1.: Schone Deine Nerven, verschwende keine Lebenszeit und Vergiss SCART! 2.: Frag mal ganz lieb den Beetle, DER bekommt das irgendwie hin und würde Dir die Maschine sicher fertig machen.

vbxe_130xe.JPG

Hier noch, was ich mit SCART maximal erreicht habe:

vbxe_nonworking.jpg

Anhänge:

/|\ ... loading .... /|\

AntwortZitat

Hmm,

also ich habe insgesamt vier VBXE´s (1x alte Version für XE (schon ewig verbaut), 3x neue (2x XE, 1x XL) und kann über solche Probleme nicht berichten 🙄.

Für die XE´s (und den XL) habe ich die SAVO Breakout Boards samt Kabel 11,90€ + 6,40€ Versand DE (bei mehreren gibt Retrohax oft sogar Rabatt) verbaut.
Die sind günstig und das Ganze rennt super und stressfrei an allen meinen Scart-Monitoren sowie auch über die Medusa.

post_andymanone_2026.10.19_08:23_1_paste_1.jpg

Gtx.,
andY

Anhänge:

Ressortleiter Hardware - Save the past and use the future!© | andYManOne | Demozoo | Live 24/7 Stream - Industrial - Chiptune/Covers - Vocal Dream - EDM - Indie - own tracks

AntwortZitat

Das probiere ich mal aus.

Das frustrierende hier ist einfach, dass es im "Selbstbau" nicht gelingen will.

Insgesamt zwei SCART-Kabel "verbraten", tausend mal durchgemessen, Widerstände berechnet - es geht einfach nicht. Davon abgesehen ist SCART auch einfach ein widerlich großer und fummeliger Stecker, so einen Müll will ich eigentlich gar nicht mehr benutzen.

/|\ ... loading .... /|\

AntwortZitat

patjomki schrieb am 14.10.2026 10:32:

Alo zwei meiner XLs haben VBXE. Wäre aber tatsächlich mal interessant, zu wissen, wie viele Clubmitglieder ein VBXE haben.

Ich habe schon lange ein VBXE in meinem XEGS. Daneben tummeln sich eine U1MB, Stereo(tfhh) Platine und Covox. Alles läuft bestens zusammen.

Angeschlossen ist das VBXE an einen voll beschalteten 9 Polige Sub-D Stecker. Nur Bild.
Somit funktioniert die komplette (GTIA und VBXE) Bildwiedergabe am Röhren Monitor und mit Adapterkabel, von 9 Poligen Sub-D Stecker auf Scart Stecker auch am TV-Röhren, LCD-TV und LED-TV mit Scart Buchse. Und ich habe einige LCD-TVs ;-)

Bekommt man nur an dem Röhren Monitor ein Bild und am TV nicht, oder ein verschwommenes Bild an LCD/LED TVs, fehlen Signale.

Das RGB Control Signal von der VBXE Platine muss als Schaltsignal an Pin 16 vom Scartanschluss. Damit der TV auf Scart Umschaltet. Nun muss noch das Composite Video (Sync) vom Monitoranschluss an Pin 20 des Scartsteckers, damit der TV weiß er muss das Bild für RGB synchronisieren. Ansonsten hüpft das Bild, weil der TV immer zwischen FBas und RGB hin und her schaltet. Auch die Masse Leitungen nicht vergessen, vom VBXE Board und Atari (Z.B. vom Modulator) an die Pins 4, 5, 9, 13 und 17 des Scart Steckers nicht vergessen.

Ich freue mich immer über neue VBXE Software.
Ob nun Mensch mit Hilfe von KI/AI oder nur Mensch, für mich ist das Ergebnis wichtig. Gefällt es mir nicht, ab in die Tonne. Wenn es gefällt, klasse. Ich sehe das alles gelassen.

AntwortZitat

fdingler schrieb am 19.10.2026 20:03:

cas, hast Du meinen "Ätzmodus" übersehen?

Hatte ich gesehen ;) und auch so verstanden.

Ich habe viel Zeit in das ATARI-Wiki investiert (wann geht das eigentlich wieder weiter?),

Wir (Peter, Roland und ich) sind dran, aber derzeit ist JHV-Vorbereitung in Prio 1 Mode. Meist hängt es an mir, und meiner nicht vorhandenen Zeit.

Das AtariWiki ist derzeit nicht erreichbar, da die KI-Crawler so viel Anfragen erzeugen, dass das alte JSP-Wiki (JSP = Java Server Pages) zu "fett" ist und zu viel CPU verbraucht und nicht mehr funktioniert.

Das neue Wiki wird wie das neue Forum und die Webseite arbeiten ... als statische Webseiten. Das wird Strom und Geld sparen und das Wiki schneller machen.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

fdingler schrieb am 19.10.2026 20:03:

Ich habe keine Ahnung von VBXE und wünsche dem Team viel Erfolg beim Erstellen einer guten Doku mit getesteten Beispielen. Ich habe viel Zeit in das ATARI-Wiki investiert (wann geht das eigentlich wieder weiter?), und hoffe, dass meine Arbeit wenigstens ein paar Leuten nützlich war. Ich gucke da immer wieder rein, weil ich weiss, da ist alles beisammen und fast 100% richtig.

Back to topic :)

Ich musste so alt werden wie ich nun einmal bin, um mir endlich mal anzugewöhnen, alles was ich so treibe auch zu notieren. Und zwar als Markdown (ich nutze da Obsidian sehr gerne) um dann gegebenfalls auch schnell mal ein kleine Anleitung, PDF, Website oder was auch immer zu generieren.

Ich habe schon lange ein VBXE XE 2.1, aber nie richtig genutzt, weil eine gute Dokumentation fehlte.

Nachdem ich nun auch noch eine Antonia 2 in den 130 XE gesteckt habe, wird´s nicht einfacher. Gerade wurden die neuen 1.27er cores (ich hatte noch 1.26) und die machen bei mir Stress: VBXE 1.27 Cores auf AtariAge

Aber electron ist aktiv dabei und wenn dann irgendwann mal alles rundläuft, habe ich vielleicht eine brauchbare Anleitung für Otto-Normal-Atarianer beisammen. :)

/|\ ... loading .... /|\

AntwortZitat

Kann mir jemand einen Link zu VBXE-Spiele geben? Da gibt es doch bestimmt ein eigenes Archiv oder so?

Ich möchte meinen (KI generierten) ATARI-Web-Emulator testen und Bomb Jack und Super Atariccan habe ich schon getestet.

Ziel war es zwar nur, dass man meine Spiele direkt auf meiner Webseite spielen kann... aber nun habe ich doch noch ein paar mehr Eigenschaften eingebaut :-D

Grüße Janko

Mein 600XL ist virenfrei!

AntwortZitat

Kveldulfur schrieb am 21.10.2026 15:14:

Kann mir jemand einen Link zu VBXE-Spiele geben? Da gibt es doch bestimmt ein eigenes Archiv oder so?

Hier madteam VBXE findest Du einige nette Sachen zum Testen.

Gruß, Ralf

PP´s of STARSOFTBerlin____github|meine Webseite|Demozoo

AntwortZitat

FYI, ich habe die Posts mit der KI-Diskussion (die ist wichtig und notwendig) in einen eigenen Thread unter "Anderes" geschoben, da hier Off-Topic.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat

Hallo Carsten,

hast du die KI-Diskussion verschoben weil wichtig, oder weil Off-Topic? Off-Topic ist ja hier auch einiges anderes, das es ja nicht im allegemeinen um die VBXE geht, sondern um eine Dokumentation zum Thema VBXE.

Zum Thema: Ich gehöre auch zu den VBXE-Besitzern, habe aber keine große Erfahrung damit. Doku ist natürlich immer hilfreich, sollte aber wie von dir erwähnt geprüft sein. Auf Ungeprüftes ob von Mensch oder KI kann ich verzichten. Frust über nicht funktionierendes sollte jedem erspart bleiben.

Grüße, Thomas

AntwortZitat

sirius800xl schrieb am 22.10.2026 10:00:

Hallo Carsten,

hast du die KI-Diskussion verschoben weil wichtig, oder weil Off-Topic?

Weil hier unter "Software/Programmierung/VBXE-Dokumentation" off-topic.

Thema hier ist eine Dokumentation für Programmierer über das VBXE.

Ich erwarte das es zum Thema "KI" noch mehr zu sagen gibt, und das ist dann in einem eigenen Thread besser aufgehoben.

https://mastodon.social/@cstrotm https://abbuc.social

AntwortZitat